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5.0 Reference 

This section describes the actual OLE Interfaces exposed, the definitions of the data structures 
used when passing data around, and the definitions of each class used internally by the XMC 
Driver Administrator Component. 

5. 1 Structures and Defines 

This section defines all structures, enumerations, and defines used by the driver. 



5.1.1 XMCJDRIVER_INFO Structure 

The following structure is used when setting up and querying the state of the driver. 

struct XMC_DRIVER_INFO 
{ 



XMC HDRIVER 


(in, out] 


m_hDriver; 


XMC DRIVER MODULETYPE 


[out] 


m_mt; 


BOOL 


(out] 


mJbStreamMgmtLocked; 


LPTSTR 


[out] 


mjps z Hardware Vendor ; 


DWORD 


(in] 


m_cbMaxHardwa re Vendor ; 


LPTSTR 


[out] 


m_pszHardwareModel; 


DWORD 


[in] 


m_cbMaxHardwareModel ; 


LPTSTR 


[out] 


m_ pszDriverVendor; 


DWORD 


tin] 


m~cbMaxDriverVendor; 



); 



5.1.2 XMC_STREAM_INFO Structure 

This structure is used to pass all stream specific data used to both setup the stream, and query the 
stream for its current settings. 

struct XMC STREAM_INFO 
{ 



XMC HSTREAM 
XMC~STREAM_MODULETY*E 



m_hStream; 
m~mt; 



union { 



); 



In- 



struct PCBus 



struct Serial 



DWORD' dwPort; 
DWORD dwIRQ; 



DWORD dwPort; 
DWORD dwBPS; 



struct TextFile 

LPCTSTR pszFileName; 

truct Custom 

DWORD dwParaml; 
DWORD dwParam2; 
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5.13 XMC^DRIVERINTERFACESUPPORTJNFO 

This structure defines all interface support information used to determine the level of XMCSPI 
supported by the driver.. 

struct XMC_ DRI VERINTER FACES U P PORT_IN FO 

( TCHAR m_szDriverName[ XMC_DRI VERNAME_MAX+ 1 ); 

DWORD m_dwInterfaceCount;~ 
XMC_INTERFACESUPPORT INFO m"rgIFSI(]; 

); 

5.1.4 XMC_INTERFAGESUPPORT_INFO 

This structure defines the support information for one interface exposed by an XMC Driver. 
Struct XMC_INTERFACESUPPORT_INFO 



TCHAR 
DWORD 

XMC METHOD SUP PORT INFO 



}; 



m_szlnterf aceName [ XMC_INTERFACENAME_MAX+1 J; 

m dwMethodCount; 

m~rgMSI[]; 



5.1.5 XMC^METHODSUPPORT^INFO 

This structure defines the support information for one method in an interface exposed by an XMC 
Driver. 

struct XMC_METHODSUPPORT_INFO 



{ 



); 



TCHAR 

XMC SUPPORTTYPE 



m_szMethodName[ XMC_METHODNAMEMAX+ 1 J; 
m st; 



5.1.6 XMC_SUPPORTTYPE 

This enumeration defines the different types of support provided for a certain method, 
enum XMC SUPPORTTYPE 



{ 



); 



XMC_ST_DRIVER, 
XMC ST STUB 



5.4 Classes 

This section contains the definition of all classes used by the XMC Driver Administrator Control 
Panel Applet in its implementation. 

5.4.1 CDriverAdmin Class 

The CDriverAdmin class is used to directly communicate with the driver administrator 
component. All OLE related details are encapsulated within this class. The following is the 
definition of the CDriverAdmin class. 

class CDriverAdmin 
{ 

publi'c: 

// Constructors & Destructors 

CDriverAdmin ( void ); 
-CDriverAdmin ( void ) ; 



// Initialization 
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DWORD Initialize ( void ); 
// Acti ns 

DWORD EnumDriver( LPENUMDRIVER *ppEnumDriver ); 

DWORD RegisterDriver( LPCTSTR pszFileName, 

BOOL bEnabled, 
LPXMC_HDRIVER phDrv ) ; 

DWORD RegisterStream( LPCTSTR pszFileName, 

BOOL bEnabled, 
XMC_HDRIVER hDrv, 
LPXMC HSTREAM phStrm ) ; 

DWORD UnRegister( XMC_HDRIVER hDrv, XMC_HSTREAM hStrm ); 

DWORD GetSupportInfo{ LPXMCDRIVERINTERFACESUP PORT INFO rgDIFS ) 
// Debugging ; 

DWORD EnableDiagnostics ( BOOL bEnable ) ; 



private : 



); 



// Private Data — 

LPXMCDRIVERADMIN m IpDA; 

LPXMCDRIVERADMIN DEBUG nTlpDADbg ; 



5.4.2 CDriverlnfoMap Class 

The CDriverlnfoMap class describes the current state of the driver administrator component 
regarding installed drivers and streams. The driver administrator CPL queries the driver 
administrator component for this block of information, that it then uses to update the user-interface 
describing the drivers and streamsunstalied. 

class CDriverlnfoMap 



{ 



public: 



// Constructors & Destructors 



CDriverlnfoMap ( void ) ; 
-CDriverlnfoMap ( void ) ; 



// Actions 



DWORD Load{ LPUNKNOWN *rgpDrvUnk, DWORD dwDrvCount, 

LPUNKNOWN •rgpStrmUnk, DWORD dwStrmCount ); 



// Public Data 



LPXMCDRIVERINFO 
DWORD 



m_rgDriverInfo[J ; 
m~cbDri verlnf o ; 
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